home *** CD-ROM | disk | FTP | other *** search
/ Aminet 49 / Aminet 49 (2002)(GTI - Schatztruhe)[!][Jun 2002].iso / Aminet / util / misc / AslToRT.readme < prev    next >
Text File  |  2002-04-14  |  10KB  |  233 lines
  1. Short:    Asl/Arp/Req/Intuition/RT requester to RT/Asl patcher
  2. Author:   tboeckel@uni-paderborn.de (Thore Boeckelmann)
  3. Uploader: tboeckel@uni-paderborn.de (Thore Boeckelmann)
  4. Type:     util/misc
  5.  
  6. TITLE
  7.   AslToRT
  8.  
  9.  
  10. VERSION
  11.   39.8
  12.  
  13.  
  14. AUTHOR
  15.   Thore Böckelmann <tboeckel@uni-paderborn.de>
  16.  
  17.  
  18. REQUIREMENTS
  19.   Any Amiga® (compatible) computer with at least OS3.0 and 68020+ cpu.
  20.  
  21.  
  22. DESCRIPTION
  23.   AslToRT is a utility that is meant to replace RTPatch by Nico François, the
  24.   original author of the ReqTools package. RTPatch has several bugs when running
  25.   under OS3.x. It uses a very tricky mechanism to patch the desired libraries
  26.   only when they are opened. This causes a very annoying behavior with
  27.   asl.library. Under OS2.x this library kept its open counter equal to zero,
  28.   which is no longer the fact for OS3.x. As a result the library's name is
  29.   changed from "asl.library" to "asl.§ibrary", where the "§" stands for an
  30.   unprintable character. The effect is, that asl.library will be loaded again
  31.   and again, because it is no longer in memory with the correct name. This is
  32.   very bad in the way Amiga shared libraries are intended to work. So you have
  33.   no longer one copy of the library in memory, but several identical copies, of
  34.   which each eats up your machines memory.
  35.  
  36.   AslToRT does all the things that RTPatch does, but in a (hopefully) much
  37.   better way. Additionally you can choose very exactly which libraries and which
  38.   functions should be patched to use the apropriate ReqTools function.
  39.  
  40.   From version 39.2 on AslToRT can behave like a fictious program called
  41.   "RTToAsl", that means it can redirect all of reqtools' requesters to the
  42.   equivalent asl requesters. The desired work mode is selected by the new
  43.   PATCHMODE option.
  44.  
  45.  
  46. USAGE
  47.   You can start AslToRT from either Workbench or Shell with the following
  48.   options:
  49.  
  50.   ASLFILE/S,ASLFONT/S,ASLSCREEN/S,ASLALL/S,INTUIAUTOREQ/S,INTUIEASYREQ/S,
  51.   INTUIALL/S,REQFILE/S,REQFONT/S,REQLONG/S,REQSTRING/S,REQTEXT/S,REQCOLOR/S,
  52.   REQALL/S,ARPFILE/S,ARPALL/S,REQTOOLSFILE/S,REQTOOLSFONT/S,REQTOOLSSCREEN/S,
  53.   REQTOOLSALL/S,ALL/S,PATCHMODE,IGNOREHEIGHT/S,CENTERTEXT/S,OVERRIDE/S
  54.  
  55.   ASLFILE/S: patch asl.library's file requesters
  56.   ASLFONT/S: patch asl.library's font requesters
  57.   ASLSCREEN/S: patch asl.library's screenmode requesters
  58.   ASLALL/S: patch all of asl.library's requesters
  59.   INTUIAUTOREQ/S: patch intuition.library/AutoRequest()
  60.   INTUIEASYREQ/S: patch intuition.library/EasyRequest()
  61.   INTUIALL/S: patch all of intuition.library's requesters
  62.   REQFILE/S: patch req.library's file requesters
  63.   REQFONT/S: patch req.library's font requesters
  64.   REQLONG/S: patch req.library/GetLong()
  65.   REQSTRING/S: patch req.library/GetString()
  66.   REQTEXT/S: patch req.library/TextRequest()
  67.   REQCOLOR/S: patch req.library/ColorRequest()
  68.   REQALL/S: patch all of req.library's requesters
  69.   ARPFILE/S: patch arp.library's file requesters
  70.   ARPALL/S: patch all of arp.library's requesters
  71.   REQTOOLSFILE/S: patch reqtools.library's file requesters
  72.   REQTOOLSFONT/S: patch reqtools.library's font requesters
  73.   REQTOOLSSCREEN/S: patch reqtools.library's screenmode requesters
  74.   REQTOOLSALL/S: patch all of reqtools.library's requesters
  75.   ALL/S: patch all requesters of every library (asl/arp/req/intuition/reqtools)
  76.   PATCHMODE: either ASL or REQTOOLS (default: REQTOOLS)
  77.   IGNOREHEIGHT/S: ignore the height of file/font/screenmode requesters and use
  78.     ReqTools' preferred window height
  79.   CENTERTEXT/S: center the body text of AutoRequest()/EasyRequest()ers
  80.   OVERRIDE/S: override fallback to asl.library for some unsupported features and
  81.     use ReqTools requesters nevertheless
  82.  
  83.   You must specify at least one of these options, else AslToRT will exit
  84.   immediately without patching anything.
  85.  
  86.   You can start and quit AslToRT at any time. Only requesters allocated after
  87.   running AslToRT will be redirected to ReqTools. To quit AslToRT simply start
  88.   it again.
  89.  
  90.  
  91. INSTALLATION
  92.   Copy AslToRT where ever you want, but SYS:WBStartup is a very good place
  93.  
  94.  
  95. KNOWN BUGS
  96.   reqtools.library is not able to emulate all details of asl.library. Especially
  97.   the very new functionality introduced with asl.library V44 (OS3.9) cannot be
  98.   done with reqtools.
  99.  
  100.   Some requesters by intuition/AutoRequest() cannot be patched to
  101.   reqtools.library because they use some tricky mechanisms to place the text
  102.   within the window, which reqtools.library cannot do (i.e. the device info
  103.   requester of DiskSalv V2+).
  104.  
  105.   Most of Workbench's and dos.library's message requesters can be redirected to
  106.   reqtools.library, but some cannot. These are the requesters that are build by
  107.   intuition/BuildSysRequest() and intuition/BuildEasyRequest() and are displayed
  108.   asynchronously. Although reqtools.library itself can do the same thing it is
  109.   not possible to emulate intuiton.library's way by reqtools.library (i.e.
  110.   Workbench's Version/Copyright requester).
  111.  
  112.   Since version 39.2 you can redirect reqtools' requesters to asl, but the
  113.   asychronous requesters of reqtools cannot be emulated by asl, therefore these
  114.   requesters will not be redirected. But as it is very hard to find programs
  115.   using reqtools.library directly these days I assume this is not a very big
  116.   drawback.
  117.  
  118.   For those who are interested, AslToRT patches the following functions (if
  119.   enabled via options):
  120.  
  121.   asl.library:
  122.     AllocAslRequest()
  123.     FreeAslRequest()
  124.     AslRequest()
  125.  
  126.   intuition.library:
  127.     AutoRequest()
  128.     EasyRequestArgs()
  129.  
  130.   req.library:
  131.     FileRequester()
  132.     GetLong()
  133.     GetString()
  134.     NewGetString()
  135.     TextRequest()
  136.     ColorRequester()
  137.     ExtendedColorRequester()
  138.  
  139.   arp.library:
  140.     FileRequest()
  141.  
  142.   reqtools.library:
  143.     rtAllocRequest()
  144.     rtFreeRequest()
  145.     rtFreeFileList()
  146.     rtChangeReqAttr()
  147.     rtFileRequest()
  148.     rtFontRequest()
  149.     rtScreenModeRequest()
  150.  
  151.  
  152. HISTORY
  153.   39.1 (03.01.2001):
  154.     - initial Aminet release
  155.  
  156.   39.2 (10.05.2001):
  157.     - result for intuition/AutoRequest() was swapped. Fixed.
  158.     - added possibility to use AslToRT for redirection of reqtools requesters to
  159.       asl instead of vice versa.
  160.  
  161.   39.3 (11.06.2001):
  162.     - sometimes files didn't pass the filter functions because the current
  163.       directory wasn't set correctly. Thus WBPattern didn't allow to select any
  164.       file. This is fixed now. Thanks to Gerhard Pircher for his testing.
  165.     - system failure requesters are now centered on the screen
  166.     - rewrote TagList handling
  167.     - when using the same asl requester several times each requester had the
  168.       name of the first request set, instead of a new one. Thanks to Gernod
  169.       Schomberg for that hint.
  170.  
  171.   39.4 (16.07.2001):
  172.     - added tool ShowReqs. This one will print a list which process allocated
  173.       which kind of requester
  174.     - when using Asl->RT mode AslToRT will fall back to Asl requesters if some
  175.       unsupported functionality of Asl is used (custom screen modes, custom draw
  176.       modes, etc). If you don't want that but see the RT requesters
  177.       nevertheless, then use the OVERRIDE option to force AslToRT to use
  178.       sub-functional RT requesters.
  179.     - the filter functions should now finally filter correctly. Many thanks to
  180.       Gerhard Pircher for his constant testing.
  181.     - new option CENTERTEXT
  182.     - added some security checks to avoid invalid default filenames
  183.  
  184.   39.5 (03.08.2001):
  185.     - font and screenmode requesters never returned a successful selection due
  186.       to some changes made in the last release (ASL -> RT mode). Thanks to Guido
  187.       Mersmann and Klaus Just for reporting this bug.
  188.  
  189.   39.6 (23.08.2001):
  190.     - file requesters didn't use the old style IDCMP and filter functions. This
  191.       is fixed now. I don't know which programs still use these obsolete
  192.       functions, but nevertheless: it is working now.
  193.     - AslToRT was exiting immediately when using the ALL option and either
  194.       arp.library or req.library was not installed. This is fixed now. Not
  195.       installed libraries will be ignored now, even if the corresponding options
  196.       are specified.
  197.     - emulated Asl file requesters didn't accept empty file selections, even if
  198.       you selected a directory. MakeCD suffered from this, because you had to
  199.       selected at least one file to make MakeCD recognize your directory
  200.       selection.
  201.  
  202.   39.7 (03.10.2001):
  203.     - file requesters didn't keep their directory buffer in ASL -> RT mode. This
  204.       is fixed now.
  205.     - when operating in RT->Asl mode the inital drawer was the same as the
  206.       requester title. At least this bug appeared with PerfectPaint. Thanks to
  207.       Stefan Martens for his hint.
  208.     - when operating in RT->Asl mode the inital drawer contained a trailing "/".
  209.       Thus PerfectPaint was not able to load a picture, because it seems to
  210.       build the complete path itself instead of using dos/AddPart(). Thanks to
  211.       Stefan Martens for his hint.
  212.  
  213.   39.8 (02.04.2002):
  214.     - AutoRequest() and EasyRequest() now use the underscore character to
  215.       highlight hotkeys for gadgets. Very few programs seem to use this, as
  216.       intuition doesn't support this!
  217.     - the ReqTools patches produced a wrong rtFileList for asynchronous
  218.       requesters. Thanks to Stefan Martens for his hint.
  219.  
  220.  
  221. COPYRIGHT AND DISCLAIMER
  222.   AslToRT is copyrighted 2001 by Thore Böckelmann.
  223.   All rights reserved. This program is freeware, so no financial donations  
  224.   required. Redistribution allowed if the package is left unchanged. The author
  225.   is not responsible for any damage caused by the use or misuse of this
  226.   documentation and/or the program(s) it describes.
  227.  
  228.   AslToRT uses the SmartReadArgs package by Thomas Aglassinger.
  229.  
  230.  
  231. SEE ALSO
  232.   ReqTools 2.9 User package
  233.